Изменение лимита департамента на поездки
Запрос позволяет изменить лимит департамента на поездки в сервисе Такси.
Синтаксис запроса
POST https://b2b-api.go.yandex.ru/integration/2.0/departments/limits/taxi/update?department_id={идентификатор департамента}
Заголовки запроса
Authorization: Bearer <OAuth-токен>
Процесс получения токена описан в разделе Начало работы.
Скопировано
X-YaTaxi-Selected-Corp-Client-Id
— ID клиента из Личного кабинета. Обязателен, если по токену доступно несколько клиентов.
Скопировано
Параметры запроса
Запрос содержит обязательный параметр:
department_id
— идентификатор департамента, по которому запрашивается лимит.
Тело запроса
Важно
В данном запросе необходимо тело (body) запроса!
Данные передаются в теле запроса в формате JSON:
Поле |
Описание |
Формат |
Обязательность |
|
Сумма, которую департамент может потратить в месяц на поездки в сервисе Такси. Неотрицательное число или |
Число |
Да |
Пример запроса
POST https://b2b-api.go.yandex.ru/integration/2.0/departments/limits/taxi/update?department_id=87e8...f646c
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>
{
"budget": 1000
}
Пример ответа
В случае успешного запроса будет возвращен пустой ответ с кодом 200.
Возможные коды ответа
Ответ на данный запрос может содержать следующие стандартные HTTP-коды:
200
— запрос выполнен успешно.400
— в запросе был передан неизвестный параметр или параметр с недопустимым значением.401
— был передан неверный OAuth-токен.403
:- SELECT_CLIENT_HEADER_REQUIRED — в запросе не передан заголовок
X-YaTaxi-Selected-Corp-Client-Id
(возвращается в случае, если для токена доступно более одного клиента). - SELECTED_CLIENT_ACCESS_DENIED — в заголовке
X-YaTaxi-Selected-Corp-Client-Id
передан ID клиента, к которому нет доступа у этого логина.
- SELECT_CLIENT_HEADER_REQUIRED — в запросе не передан заголовок
404
— департамента с указаннымdepartment_id
не существует.
Скопировано
Была ли статья полезна?
Предыдущая
Следующая